Shifts

Shifts are job offers posted by Facility Users on behalf of Facilities to the Nursa Marketplace. This process allows healthcare facilities to communicate their staffing needs and find qualified clinicians to fill available positions. Once a shift request is processed, it is added to our marketplace and displayed to clinicians.

Clinicians can then review these shifts and, if interested, submit a request to be scheduled for the shift.

Prerequisites

Before you can start posting shifts you need to have a valid facility connection.

You can refer to the Facility Onboarding Guideline in order to know how you can have a valid facility connection.

You can fetch all the facilities you have connection with using our Get Facilities endpoint.

Also you need to specify the License Type of the shift you want to create, you can retrieve all the available Nursa License in the Get Licenses endpoint.

Creating Shifts

Once you have the facilityId of the facility that you want to post a shift, and the License Type you can start creating shifts in our application.

You can use our bulk Create Shifts endpoint to create several shifts at once.

info

The price of each shift will be based on the from, to,licenseType and on the breakTime parameter values.

Parameter	Type	Description
facilityId required	string	ID of the facility
shifts required	array	Array of shift objects
├─ licenseTyperequired	string	License type of the shift (e.g., RN)
├─ from required	string (ISO 8601)	Start time of the shift in ISO 8601 format
├─ to required	string (ISO 8601)	End time of the shift in ISO 8601 format
├─ description required	string	Description of the shift
└─ breakTime	string (ISO 8601 duration)	Break Time for the shift in ISO 8601 format

Example payload:

{
    "shifts": [
        {
            "licenseType": "RN",
            "from": "2024-01-01T14:00:00.000Z",
            "to": "2024-01-01T17:00:00.000Z",
            "description": "RN Shift",
            "breakTime": "PT15M"
        },
        {
            "licenseType": "CNA",
            "from": "2024-06-28T14:00:00.000Z",
            "to": "2024-06-28T17:00:00.000Z",
            "description": "CNA Shift"
        }
    ],
    "facilityId": "P-123456"
}

Quoting Shift Price

If you want to check the shift price before creating it, you can quote the shift price, once a Shift Quote is created, you'll have 15 minutes to create the shift based on quote

Retrieving Shifts

In order to retrieve the shifts that are currently open in Nursa marketplace you can use our Get marketplace shifts endpoint, you can narrow your research using the following query parameters

Parameter	Type	Description
facilityId	string	ID of the facility
startDateFrom	string (ISO 8601)	The start date of the range to filter shifts, when this parameter is provided, startDateTo parameter becomes required
startDateTo	string (ISO 8601)	The end date of the range to filter shifts
limit	number	Use to specify the quantity of records returned, if not provided, a default value of 10 will be applied
offset	number	Use to specify the number of records to skip before starting to return results, if not provided, the default value will be 0
sortDirection	string	Use to specify the order of records by creation date, either ASC for ascending or DESC for descending, the default value will be DESC

Example request

curl --location 'https://public-api-stage0.stage.nursa.com/api/v2/public/marketplace/shifts?offset=0&limit=10&sortDirection=ASC&startDateFrom=2024-01-01T00:00:00.000Z&startDateTo=2024-01-07T00:00:00.000Z&facilityId=P-1714111851830' \
--header 'Authorization: Bearer TOKEN'

Updating Shift

Once the shift is created, you can update it, but you'll only be able to update it's description, or add a monetary bonus that will be payed to the clinician.

Parameter	Type	Description
description	string	Description of the Shift
bonus	number	Monetary bonus to clinician

Removing the Shift

If you need to remove the shift from Nursa Marketplace, please refefer to the Cancelation Guideline